home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d17 / lj2dj.arc / README.DOC < prev   
Text File  |  1990-02-15  |  12KB  |  273 lines
  1.                                                                 Sept 20, 1989
  2.  
  3.                            LJ2DJ (Version 1.3)
  4.  
  5.           (C) Copyright 1989 by TaxWare, PO Box 2014, Provo, UT  84603
  6.                All rights reserved
  7.  
  8.  
  9.     LJ2DJ is a program used to convert Hewlett-Packard LaserJet format soft
  10. files to DeskJet soft font files.  The version included with this package is
  11. sharware and is limited in its features.  The limitations are noted throughout
  12. this document.  If you have any questions or suggestions regarding this 
  13. software, please direct them to the address above, or CompuServe ID 76704,70.
  14. Also, if you print this document, you should set tab stops to 8.
  15.  
  16.   o    limited to converting 8 point through 12 point fonts.
  17.   o    limited to converting one font at a time.
  18.   o    limited command line options (see Options below).
  19.  
  20.  
  21. The syntax/usage of LJ2DJ is:
  22.  
  23.     LJ2DJ [options] LaserJetFontFilePath [DeskJetFontFilePath]
  24.  
  25. If you need help using LJ2DJ, simply type LJ2DJ at the DOS prompt and press the 
  26. Enter key.  A usage screen, such as the following will appear:
  27.  
  28. ╔═════════════════════════════════════════════════════════════════════════════╗
  29. ║                                           ║
  30. ║ Usage: LJ2DJ [options] LaserJetFontFilePath [DeskJetFontFilePath]          ║
  31. ║   where LaserJetFontFilePath and DeskJetFontFilePath are valid DOS          ║
  32. ║   paths for (respectively) an HP format LaserJet soft font file,          ║
  33. ║   and for the DeskJet soft font file to be created.  DeskJetFontFilePath    ║
  34. ║   is optional.  If it is not specified, the resulting filename will          ║
  35. ║   be the same as the LaserJetFontFilePath, except for the extension,          ║
  36. ║   which will be DJP for portrait fonts and DJL for landscape fonts.          ║
  37. ║                                           ║
  38. ║ This registered version supports wildcards in the LaserJetFontFilePath.     ║
  39. ║ If wildcards are specified, DeskJetFontFilePath is optional, and if used,   ║
  40. ║ must be of the form [d:][path], where d is a drive letter and path is a     ║
  41. ║ directory name.                                  ║
  42. ║                                           ║
  43. ║ Options                                      ║
  44. ║    /A automatically answer user prompts.                      ║
  45. ║    /M create fonts for the original DeskJet only.                  ║
  46. ║    /O overwrite DeskJetFontFilePath, if it already exists.              ║
  47. ║    /W create character width table.                          ║
  48. ║                                           ║
  49. ║ Refer to the README.DOC file for detailed information.              ║
  50. ║                                           ║
  51. ╚═════════════════════════════════════════════════════════════════════════════╝
  52.  
  53.  
  54. Operation
  55.  
  56.     The following outlines the steps to be taken when converting 
  57.     LaserJet soft fonts to DeskJet format:
  58.  
  59.     1) locate the LaserJet soft font(s) that you want to convert to
  60.     DeskJet format.  You will need to know the file path of your LaserJet 
  61.     soft font file(s).
  62.  
  63.     2) decide whether you need all of the characters from the original
  64.     font or a limited character set.
  65.  
  66.     3) decide whether you need a character width table (also known as a
  67.     spacing table).  See the /W option for more information.
  68.  
  69.     4) decide whether your new fonts must work with the original DeskJet,
  70.     or if they are to work with both the original DeskJet and DeskJet Plus.
  71.     (The DeskJet Plus can accept any font the original DeskJet can, but 
  72.     the original DeskJet cannot accept all fonts that the Plus can.)  See
  73.     the /M option for more information.
  74.  
  75.     5) type LJ2DJ followed by any options (see Options below), followed by
  76.     the path of your LaserJet font(s) and answer the prompts.
  77.  
  78. A typical conversion session might look something like this:
  79.  
  80. ╔═════════════════════════════════════════════════════════════════════════════╗
  81. ║                                           ║
  82. ║C>LJ2DJ TR120RPN.USP<Enter>                              ║
  83. ║                                          ║
  84. ║LJ2DJ Version 1.3ß                                    ║
  85. ║(C) Copyright TaxWare 1989.  All Rights Reserved.                   ║
  86. ║LaserJet To DeskJet Soft Font Conversion Utility                  ║
  87. ║                                          ║
  88. ║To receive the full-featured version of LJ2DJ, send $35 to the address below.║
  89. ║Once registered, you will receive the most recent full-featured version      ║
  90. ║and continued upgrade information.  When registering, please include          ║
  91. ║the version of LJ2DJ that you are using.                      ║
  92. ║Your registered version will NOT contain this message.                  ║
  93. ║                                          ║
  94. ║        Send cash, check or money order to:                  ║
  95. ║        TaxWare, PO Box 2014, Provo, UT 84603                   ║
  96. ║                                          ║
  97. ║Press any key to continue                              ║
  98. ║                                          ║
  99. ║Converting C:\FONTS\TR120RPN.USP                          ║
  100. ║        To C:\FONTS\TR120RPN.DJP                                ║
  101. ║                                          ║
  102. ║Are You Entering A List Of Characters To [I]NCLUDE Or [E]XCLUDE E          ║
  103. ║Enter The ASCII Value Of Each Character To Be Excluded                  ║
  104. ║Enter A Period (.) When Done                              ║
  105. ║>.                                          ║
  106. ║                                          ║
  107. ║! " # $ % & ' ( ) * + , - . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ? @ A B C D E F  ║
  108. ║G H I J K L M N O P Q R S T U V W X Y Z [ \ ] ^ _ ` a b c d e f g h i j k l  ║
  109. ║m n o p q r s t u v w x y z { | } ~                           ║
  110. ║                                          ║
  111. ║    1 Font(s) Converted.                              ║
  112. ╚═════════════════════════════════════════════════════════════════════════════╝
  113.                                           
  114.                                           
  115. Examples                                      
  116.                                           
  117.     LJ2DJ C:\FONTS\AE0060RH.SFP 6PTFONT.DJP                      
  118.                                           
  119. will convert a font file named AE0060RH.SFP located in the FONTS subdirectory of
  120. the C: drive.  The resulting DeskJet font file will be created in the current 
  121. directory and be named 6PTFONT.DJP.                          
  122.                                           
  123.     LJ2DJ C:\FONTS\AE0060RH.SFP                          
  124.                                           
  125. will convert the same font, but the resulting DeskJet font file will be       
  126. AE0060RH.DJP (assuming portrait orientation), created in the C:\FONTS directory.
  127.  
  128.     LJ2DJ C:\FONTS\*.SFP
  129.  
  130. will create DeskJet fonts for all fonts that match the pattern *.SFP in the
  131. C:\FONTS directory.  The resulting files will also be in the C:\FONTS 
  132. directory, and will have the same file name with extensions of either DJP or
  133. DJL, depending upon the fonts' orientation.
  134.  
  135.     LJ2DJ C:\FONTS\*.SFP C:\FONTS\DJ
  136.  
  137. will create DeskJet fonts for all fonts that match the pattern *.SFP in the
  138. C:\FONTS directory.  However, the resulting files will be created in the 
  139. C:\FONTS\DJ directory, which must already exist.
  140.  
  141.  
  142. Options
  143.  
  144.     /A    automatically respond to user prompts.  This option allows you
  145.         to perform unattended "batch" conversions.  The following 
  146.         assumptions are made with this option:
  147.  
  148.         Existing DeskJet font files will be overwritten.
  149.  
  150.         All characters contained in the LaserJet fonts that are not too
  151.         large for the DeskJet *Plus printer will be selected.
  152.         (* original DeskJet if the /M option is also specified)
  153.         This option is only valid with registered versions of LJ2DJ.
  154.  
  155.     /M    create only fonts that will work with the original DeskJet.
  156.         Without this option, LJ2DJ attempts to make fonts that will
  157.         work with both the DeskJet and the DeskJet Plus printers.  Such
  158.         a font is referred to as a DeskJet font.  If the font to be 
  159.         made has characters too tall for a DeskJet font, or is being 
  160.         created from a landscape font with fixed spacing, the user
  161.         will be informed that only a DeskJet Plus font can be created.
  162.         The user will then have the option to continue creating the
  163.         DeskJet Plus font, to reselect a new character set, or to abort
  164.         the creation of the current font.
  165.  
  166.         LJ2DJ /M /A F:\LJFONTS\*.* D:
  167.  
  168.         This example will create fonts that will work with both the
  169.         DeskJet and the DeskJet Plus from all LaserJet soft font files
  170.         in the LJFONTS subdirectory of the F: drive.  LaserJet fonts 
  171.         whose conversion would result in DeskJet Plus fonts are 
  172.         ignored.  This option is a time saving option usually used when 
  173.         specifying wildcard conversions.
  174.         This option is only valid with registered versions of LJ2DJ.
  175.  
  176.         (Why call it /M?  DeskJet Plus, DeskJet [M]inus!)
  177.  
  178.     /O    allows you to overwrite files with the same name as the 
  179.         DeskJet font files to be created, without having to confirm the
  180.         overwriting each time.
  181.  
  182.         LJ2DJ /O C:\FONTS\*.SFP
  183.  
  184.         will create DeskJet fonts for all files that match the 
  185.         pattern *.SFP in the C:\FONTS directory.  If any of the files
  186.         to be created already exist, they will be automatically 
  187.         overwritten.
  188.  
  189.     /W    create a character width table (file) that contains the 
  190.         information for each DeskJet font being created.  The file name
  191.         for the table is DJ_WIDTH.TAB and is created in the same 
  192.         directory as the new DeskJet fonts.  Information includes
  193.         the font file name, the font name, orientation, point size, 
  194.         baseline distance, cell width, cell height, and each character
  195.         code in decimal and hexadecimal with their corresponding left
  196.         pad, symbol width, right pad and cursor move.  If a character
  197.         width table already exists from previously running LJ2DJ, 
  198.         rename or copy it to another file if you need it.  (Each time
  199.         LJ2DJ is run with the /W option, a new width table is created.)
  200.         
  201.  
  202. Registration
  203.  
  204. When you register, please include the version of software that you are 
  205. currently using as well as the name of the person/company to which the 
  206. software is registered.
  207.  
  208. With each $35 registration fee received, you will receive two copies of the
  209. most recent version of LJ2DJ.  Both copies will be registered to you, but 
  210. one copy will contain the screen introducing the software as shareware, so that
  211. you may distribute that copy.
  212.  
  213. Copyright Notice and Disclaimer
  214.  
  215. LJ2DJ is a copyrighted program.  No fee is charged for the non-commercial 
  216. evaluation of this program by individuals.  However, the shareware 
  217. (user-supported) concept is in effect.  A $35 fee is requested from those who 
  218. do use this program.
  219.  
  220. LJ2DJ may be copied and distributed to others provided that the three 
  221. following conditions are met:
  222.  
  223.     (1) The files containing the program (LJ2DJ.EXE) and this document 
  224.         (README.DOC) are distributed together, as a single package.
  225.  
  226.     (2) No alterations are made to the contents of either file.
  227.  
  228.     (3) No fee, payment, service charge, or voluntary donation is requested 
  229.         or accepted.
  230.  
  231. The operation of LJ2DJ is not warranted in any way, nor will TaxWare be
  232. responsible for damages or losses that may result from its use.
  233.  
  234.  
  235. Revision History
  236.  
  237. Version 1.0 (Sept 14, 1989) is the first released version.
  238.  
  239. Version 1.1 (Sept 16, 1989)
  240.     fixed a bug where the total number of characters selected by the user
  241.     was accumulated in a variable of type 'unsigned char.'  In the 
  242.     extremely rare case that if a font with 256 characters (0-255) were to
  243.     be converted, this number would wrap back to 0, causing the 'No
  244.     Characters Selected' message to appear, while aborting the conversion.
  245.     The variable has been changed to the type 'unsigned int.'
  246.  
  247. Version 1.2 (Sep. 20, 1989)
  248.     Fixed an error in the evaluation version that allowed fonts between 8
  249.     and 16.8 points to be rotated instead of the documented 8 to 12 point 
  250.     range.  (Thanks, Joan!)
  251.  
  252. Version 1.3 (Nov. 9, 1989)
  253.     Fixed an error that would cause "spurious dots" to be printed, usually
  254.     above the shorter, lower-case letters.  This error was manifested when
  255.     some characters of a *multi-pass font did not extend into the next 
  256.     higher region of the "print head."  Thus, no information was included 
  257.     in the produced DeskJet font file which explicitly indicated that such
  258.     shorter characters had NO information in the higher regions.  Now, 
  259.     multi-pass information is included for all characters of a multi-pass
  260.     font, and for ALL regions, even though such information would 
  261.     intuitively be unnecessary.  With this change, slightly larger font
  262.     files are produced for fonts with such parameters.
  263.  
  264.     * a DeskJet font which has one or more characters taller than 50 dots
  265.     (approximately 1/6") is a multi-pass font.
  266.  
  267. Reports of perceived bugs or suggestions for improvements are also appreciated.
  268.  
  269. TaxWare
  270. PO Box 2014
  271. Provo, UT  84603
  272.  
  273.